# ADB terminal

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

**ADB** stands for **Android Debug Bridge**, which is a command-line toolkit serving as a versatile tool for Android development and debugging.

Simply put, **ADB** is a "universal data cable" that connects your computer to a device (or emulator), allowing you to directly control and deeply manage the device on your computer.

The **ADB** port of **Quectel Pi H1** Smart Single-Board Computer is shown in the following figure:

```{image} images/image_ScELbWLxWoFB6nx9BZHcKX9mnQC.webp
:width: 904px
:height: 506px
```

# Preparation

1. Prepare a **USB to Type-C** cable to connect the computer to the **Quectel Pi H1** Smart Single-Board Computer.

2. Download the [platform-tools](<https://www.quectel.com.cn/wp-content/uploads/2026/08/platform-tools.zip>) tool on your computer and unzip it.

# Enable and disable ADB

The **ADB** service is enabled by default in the system. To disable the **ADB** service, you can execute the following command:

```bash
sudo systemctl stop android-tools-adbd
sudo systemctl disable android-tools-adbd
sudo reboot
```

If you want to restart the **ADB** service after disabling it, you can execute the following command:

```bash
sudo systemctl start android-tools-adbd
sudo systemctl enable android-tools-adbd
sudo reboot
```

# Usage method

1. Open the folder where the **platform tools** tool is located, enter **cmd** in the top path box, press enter to open the **adb** terminal.

```{image} images/image_QVKBbHx8fofRh3xCJjTcBSktnVc.webp
:width: 1292px
:height: 835px
```

```{image} images/image_EpvnbYQ9oosrVQxlApZcraS0naf.webp
:width: 1285px
:height: 831px
```

```{image} images/image_CorSb17IloyXPRxFuHNcYWe2nbh.webp
:width: 973px
:height: 505px
```

2. Enter the **adb** command in the terminal.

View connected devices:

```bash
adb devices
```

Transfer files from computer to device:

```bash
# For example, adb push C:\Users\james.liu\Desktop\11.txt /data/local/tmp/
adb push <computer file path> <device storage path>
```

- You can drag and drop files on your computer to the **adb** terminal to obtain the <computer file path>.

Transfer files from devices to computers:

```bash
# For example, adb pull /data/local/tmp/11.txt .
adb pull <device storage path> <computer file path>
```

- . means to pull the file to the current **adb** terminal folder, which is the **platform tools** folder.

Enter the device **shell** terminal:

```bash
adb shell
```

```{image} images/image_NkMDbSh7Foh50ZxoTqpcc3QunBf.webp
:width: 972px
:height: 506px
```

- After entering the **shell** terminal, the user identity defaults to **root**.

- If you want to exit the **shell** terminal, enter exit.